home *** CD-ROM | disk | FTP | other *** search
/ Toolkit for Civilization 2 / Walnut Creek CDROM - Toolkit for Civilization II.iso / docs / pv.doc < prev    next >
Text File  |  1996-07-30  |  15KB  |  408 lines
  1.  
  2.           ┌────────────────────────────────────────────────┐
  3.           │  Documentation for PowerView -Special Edition  │
  4.           ├────────────────────────────────────────────────┤
  5.           │                  Version 1.02                  │
  6.           └────────────────────────────────────────────────┘
  7.  
  8. Note: This documentation is pleminary, and will be revised
  9.           substantialy in the shareware release.
  10.  
  11. Poweriew is a DOS based image viewing program that views most popular
  12. image file formats.  Images may be viewed, modified and re-saved
  13. in different formats.
  14.  
  15. PowerView comes with SciTech's UniVBE Driver built in.
  16. UniVBE is a Universal VESA BIOS Driver for over 160 different
  17. Graphics Chips.  Installation is simple and painless.
  18.  
  19. Files Included:
  20.  
  21.         PV       EXE       Main Program
  22.         UVC_EXEC EXE       Setup Manager
  23.         UVCONFIG EXE       UniVBE Configuratin
  24.         PV       DOC       This File
  25.         FEATURES DOC       Discussion of PowerView features
  26.         REGISTER DOC       Information on Registering PowerView
  27.         FILE_ID  DIZ       Banner File for BBS's
  28.  
  29.  
  30. System Requirements:
  31.  
  32.         *  A 386sx or greater CPU is required.
  33.         *  A VGA display is required.
  34.         *  512K free conventional memory is required.
  35.         *  MS-DOS or PC-DOS 5.0 or later is required.
  36.  
  37. Optional System Features:
  38.  
  39.         * A mouse.
  40.         * VESA BIOS extensions to access resolutions beyond the
  41.           VGA standard such as 800x600 @ 256 colors, etc.
  42.         * 600+K free conventional memory.
  43.         * XMS and/or EMS memory.  The more the better.
  44.  
  45.  
  46.                  Keys Available from the Desktop
  47.                  -------------------------------
  48.  
  49. "A"-"Z", "a"-"z", ...... Move to the next file or directory
  50. "0"-"9", ".", "@"        that starts with that character
  51.  
  52. Enter .................. View currently selected file
  53. Space .................. Tag/untag current file and advance to next file
  54. Backspace .............. Tag/untag current file and advance to last file
  55. Tab .................... Tag/untag next 5 files
  56. Shift+Tab .............. Tag/untag next 25 files
  57.  
  58. F1 ..................... Help
  59. F2 ..................... Begin Slideshow
  60. F3 ..................... Directory history list (very useful)
  61. F4 ..................... Lock "auto" video mode selection
  62. F5 ..................... Go to last available video mode
  63. F6 ..................... Go to next available video mode
  64. F7 ..................... Assign Alt+Fkey Directories
  65. F8 ..................... Change current file mask
  66. F9 ..................... Change current directory
  67. F10 .................... Activate Pull-down Menus
  68. F12 .................... Display Extended file description
  69.  
  70. Alt+F1 to Alt+F9 ....... Goto Pre-assigned Directory
  71. Alt+F10 ................ Goto Startup Directory
  72.  
  73. Alt+Q, Alt+X, Esc ...... Quit program
  74.  
  75. Alt+T .................. Tag all files
  76. Alt+U .................. Untag all files
  77. Alt+1 .................. Tag/untag all files
  78. Alt+2 .................. Go to first directory
  79. Alt+3 .................. Go to first file
  80. Alt+A .................. Quick Locate File by Name
  81.  
  82. Alt+E .................. Recursively Search for File
  83. Alt+N .................. Resume last Recursive Search
  84.  
  85. Alt+Z .................. Delete (Zap) file(s) or directory
  86. Alt+R .................. Rename file or directory
  87. Alt+C .................. Copy file(s)
  88. Alt+M .................. Move file(s)
  89. Alk+K .................. Make new Subdirectory
  90.  
  91. < ...................... Go to last available video mode
  92. > ...................... Go to next available video mode
  93.  
  94. ? ...................... Display Full File Descriptions
  95.  
  96.                 Special Keys Recognized when an Image is Displayed
  97.                 --------------------------------------------------
  98.  
  99. "[" or "{" or "/" ...... Go immediately to the previous image in file list
  100. "]" or "}" or "*" ...... Go immediately to next image in file list
  101.  
  102. "<" or "," ............. Switch to previous video mode
  103. ">" or "." ............. Switch to next video mode
  104. "?" .................... Display Current Video Mode
  105.  
  106. F ...................... Display Current File and File Size
  107. V ...................... Display Current Image Size
  108.  
  109. M ...................... Reset video Mode
  110. N ...................... Lock video mode (stands for "no mode change")
  111. B ...................... Blank the Screen, Press any key to Unblank
  112.  
  113. T ...................... Tag image currently being viewed
  114. U ...................... Untag image currently being viewed
  115.  
  116. Alt+Q, Alt+X ........... Quit program immediately
  117.  
  118. Z ...................... Toggle Zoom mode on/off.  EMS required
  119.  
  120. F1 ..................... Help
  121.  
  122. F2 ..................... Save Current Image
  123.  
  124.                         File Saving Options
  125.                         -------------------
  126.  
  127. Alt+G .................. Save image as .GIF file
  128.                          (2, 4, 8, 16, 32, 64, 128, 256 colors)
  129. Alt+I .................. Save image as Interlaced .GIF file
  130.                          (2, 4, 8, 16, 32, 64, 128, 256 colors)
  131. Alt+P .................. Save image as .PCX file
  132.                          (2, 8, 16, 256, 16m colors, rle comp)
  133. Alt+F .................. Save image as .TIF file
  134.                          (2, 16, 256, 16m colors, no comp)
  135. Alt+T .................. Save image as .TGA file
  136.                          (256, 32k, 16m colors, no comp)
  137. Alt+B .................. Save image as .BMP file
  138.                          (2, 16, 256, 16m colors, no comp)
  139. Alt+A .................. Save image as Raw image file
  140.                          (256, 32k, 64k, 16m colors)
  141.  
  142.                 Special Keys Recognized in 16 and 256 Color Modes
  143.                 -------------------------------------------------
  144.  
  145. The following keys work in 16 and 256 color modes only:
  146.  
  147. 8 ...................... Toggle 8-bit RAMDAC support on/off
  148.  
  149. G ...................... Color-kill on/off (or greyscale)
  150.  
  151. I ...................... Inversion on/off
  152.  
  153. A ...................... Cycle palette on/off (press ESC, a mouse  button,  or
  154.                          "A" to stop cycling)
  155.  
  156. C ...................... Component swap  (cycles  through  all combinations of
  157.                          the RGB components: RGB, RBG, BGR, etc.)
  158. Ctrl+C ................. Component swap reset
  159.  
  160. "1", Shift+"1" ......... Red Component -
  161. "2", Shift+"2" ......... Red Component +
  162. Ctrl+"1", Ctrl+"2" ..... Red Component Reset
  163.  
  164. "3", Shift+"3" ......... Green Component -
  165. "4", Shift+"4" ......... Green Component +
  166. Ctrl+"3", Ctrl+"4" ..... Green Component Reset
  167.  
  168. "5", Shift+"5".......... Blue Component -
  169. "6", Shift+"6" ......... Blue Component +
  170. Ctrl+"6", Ctrl+"7"...... Blue Component Reset
  171.  
  172. F7, Shift+F7 ........... Brightness -
  173. F8, Shift+F8 ........... Brightness +
  174. Ctrl+F7, Ctrl+F8 ....... Brightness Reset
  175.  
  176. F9, Shift+F9 ........... Contrast -
  177. F10, Shift+F10 ......... Contrast +
  178. Ctrl+F9, Ctrl+F10 ...... Contrast Reset
  179.  
  180. F11, Shift+F11 ......... Color Saturation -
  181. F12, Shift+F12 ......... Color Saturation +
  182. Ctrl+F11, Ctrl+F12 ..... Color Saturation Reset
  183.  
  184. W, Shift+W ............. Hue Rotate +
  185. S, Shift+S ............. Hue Rotate -
  186. Ctrl+W, Ctrl+S ......... Hue Reset
  187.  
  188. E, Shift+E ............. Linear Brightness +
  189. D, Shift+D ............. Linear Brightness -
  190. Ctrl+E, Ctrl+D ......... Linear Brightness Reset
  191.  
  192. O, Shift+O ............. Gamma +
  193. L, Shift+L ............. Gamma -
  194. Ctrl+O, Ctrl+L ......... Gamma Reset
  195.  
  196. R ...................... Toggle between original settings and new settings
  197. Ctrl+R ................. Resets all settings, does not toggle
  198.  
  199.                 Special Keys Recognized in Zoom Mode
  200.                 ------------------------------------
  201.  
  202. Tab .................... Increase zoom factor (zoom mode only)
  203. Shift+Tab .............. Decrease zoom factor (zoom mode only)
  204. + ...................... Increase zoom factor (zoom mode only)
  205. - ...................... Decrease zoom factor (zoom mode only)
  206.  
  207.                 Special Keys Recognized During Slide Show
  208.                 -----------------------------------------
  209.  
  210. U ...................... Untag image currently being viewed (beeps to acknowledge)
  211. T ...................... Tag image currently being viewed (beeps to acknowledge)
  212. P ...................... Pause (Press enter or space to resume slide show)
  213. Enter, Space ........... Go immediatly to next image (if it's available)
  214.  
  215.  
  216. Usage Notes:
  217.  
  218.         * The first time you run PowerView (PV.EXE) you are given the
  219.           option to setup the UniVBE driver.
  220.         * If you do not use UniVBE, you may find that hardware panning
  221.           is buggy in some older VESA BIOS's and is turned off
  222.           in VESA modes by default.
  223.         * XMS and EMS memory allows the program to run faster and
  224.           process very large images.
  225.         * If insufficent memory is available for some complex functions
  226.           such as JPEG rescaling with Multipass & Dither, the program
  227.           will turn off functions until enough memory to run is available.
  228.         * EMS memory is helpful, and without it the I-cache and Zoom
  229.           features are not available.
  230.         * A mouse is helpful, but not required to run.
  231.         * File Descriptions in the file '00_index.txt' are supported
  232.  
  233.         * The first time you run the program, it is a good idea to go
  234.           through each item in the Setup pulldown menu.
  235.  
  236.  
  237.  
  238.                           Formats Currently Supported
  239.                           ---------------------------
  240.  
  241.   GIF
  242.   ---
  243.  
  244.   All Types
  245.  
  246.   GIF87a and limited GIF89a support
  247.  
  248.   Views GIF images with a Macintosh fork header
  249.  
  250.   Max. Res. 3072x4096
  251.  
  252.   Limitations: GIF89a  extensions are not supported.
  253.  
  254.   PCX
  255.   ---
  256.  
  257.   2, 8, 16, 256, and true color
  258.  
  259.   Max. Res. 3072x4096
  260.  
  261.   BMP
  262.   ---
  263.  
  264.   2, 16, 256, and true color, compressed or uncompressed
  265.  
  266.   Both Windows and OS/2 1.x versions
  267.  
  268.   max. res.  2048x4096
  269.  
  270.   Limitations:  The  lastest  OS/2 2.x bitmaps are not supported.
  271.  
  272.   LBM/IFF/BBM
  273.   -----------
  274.  
  275.   2, 4, 8, 16, 32, 64, 128, and 256 color, compressed or uncompressed,
  276.   enhanced or unenhanced
  277.  
  278.   6 bit extra-halfbright mode
  279.  
  280.   Images without a colormap (grayscale)
  281.  
  282.   Max. Res. 2048x4096
  283.  
  284.   Limitations: HAM and SHAM files can't currently be viewed.
  285.  
  286.   MAC
  287.   ---
  288.  
  289.   All Types (with or without a Macintosh fork header)
  290.  
  291.   TIF
  292.   ---
  293.  
  294.   Supports: 2 color grayscale/palettised, 16 color grayscale/palettised,
  295.   256 color grayscale/palettised, 24 bit true color, and 32 bit CMYK
  296.  
  297.   Compression: None, Macintosh PackBits, and LZW
  298.  
  299.   Horizontal differentation, or "predictors", are supported
  300.  
  301.   Max. Res. 3072x4096
  302.  
  303.   Notes:  No  TIFF decoder can claim 100% TIFF support.  However, PV's
  304.   TIFF decoder should be able to view most of the popular TIFF variants.
  305.  
  306.   Limitations:  The  FAX style compression algorithms (Group 3 and Group
  307.   4) are currently unsupported.  Images with planar configurations other
  308.   than one are not supported.
  309.  
  310.   TGA
  311.   ---
  312.  
  313.   256 color, 15 bit, 16 bit, 24 bit, and 32 bit compressed or uncompressed
  314.  
  315.   Max. Res. 3072x4096
  316.  
  317.   Limitations: The official TGA spec states that  RLE  runs  should  not
  318.   cross  scanline  boundries.  As usual, nobody cares about the official
  319.   spec, so this  requirement  is  sometimes  ignored  by developers.
  320.  
  321.   JPG
  322.   ---
  323.  
  324.   The JPEG decoder supports the baseline DCT and  extended  sequential
  325.   DCT based modes of operation, with or without a JFIF marker, with the
  326.   following sampling factors/colorspaces:
  327.  
  328.         1. YH2V2, CbH1V1, CrH1V1 (the most popular)
  329.  
  330.         2. YH1V2, CbH1V1, CrH1V1
  331.  
  332.         3. YH2V1, CbH1V1, CrH1V1
  333.  
  334.         4. YH1V1, CbH1V1, CrH1V1
  335.  
  336.         5. YH1V1, (256 color grayscale)
  337.  
  338.         6. CMYK, 1:1:1:1 (or 1x1, 1x1, 1x1, 1x1)
  339.  
  340.         7. CMYK, 4:1:1:4 (or 2x2, 1x1, 1x1, 2x2)
  341.  
  342.         Notice that for  the  YCbCr  colorspace  both chrominance components
  343.         must be sampled at H1V1, and that the maximum horizontal or vertical
  344.         luminance sampling factor is two.
  345.  
  346.         The CMYK colorspace code has only been tested with images written by
  347.         Adobe's  Photostyler  program.   Also, the preview mode is not
  348.         currently available for CMYK images, because I'm too lazy to
  349.         implement it.  (Who cares? Hardly any DOS or Windows programs support
  350.         CMYK images anyway.)  The CMYK to RGB conversion code is written in C,
  351.         and is quite simple, so don't expect it too look very good or perform
  352.         very quickly.
  353.  
  354.         The maximum supported resolution is 3072x4096.  (An image this size
  355.         would require lots of memory to decode, so images this big may not
  356.         be viewable.  The maximum practical resolution is probably around 1024
  357.         to 2048 pixels per scan line or so.  This depends on the sampling
  358.         factor and colorspace, of course.)
  359.  
  360.         Non-interleaved files are not supported.  In other words,  the  JPEG
  361.         data segment must contain a single scan: multiple scans are not
  362.         currently supported, and may never be.  These files are rare, to say
  363.         the least, so don't worry about it.
  364.  
  365.         My Huffman decoder currently skips restart markers.  I currently do
  366.         not use them for error recovery on corrupted JPEG files.
  367.  
  368.         About decoding speed: The following  three  factors  greatly  affect
  369.         decoding speed:
  370.  
  371.         1. Image detail: Highly detailed images take longer to decode.
  372.  
  373.         2. The JPEG  quality  setting:  The  higher the quality setting, the
  374.            slower the decompression.
  375.  
  376.         3. The sampling  factor  used (for color images only): Images with a
  377.            1x1 sampling factor decode  more  slowly  than  images with a 2x2
  378.            sampling  factor.   Most  color JPEG images in existance on BBS's
  379.            use the 2x2 sampling factor (for good reasons).
  380.  
  381.         To get the most out of JPEG images, use a video card which supports
  382.         the true color video modes.
  383.  
  384.         I don't know if the JPEG files written by Adobe Photoshop can be
  385.         viewed by my decoder yet...   I've heard that these files may be
  386.         non-standard.
  387.  
  388.         If you want the fastest possible  JPEG  viewing in 256 color modes,
  389.         turn off "Dither/256" and "Multipass/256".  If you want the best
  390.         quality, then turn both of these options on.  I highly recommend you
  391.         experiment with the 4 combinations of these values so you can settle
  392.         on one that suites you best.  (I use Dither/256 = off and
  393.         Multipass/256 = on.)   Be sure you have lots of available EMS or XMS
  394.         memory if you turn multipass on, otherwise PowerViewI will use your
  395.         hard disk to hold the decoded image, which is much slower.
  396.  
  397.         In Hi-Color modes: I don't recommend you turn on "Dither/Hi-Color"
  398.         unless your machine is very fast because Floyd-Steinburg dithering is
  399.         very slow...  (On most photographic images you can't even tell a
  400.         difference anyway.)
  401.  
  402.         About JPG previews: The JPEG preview mode is fast!   If your video
  403.         card does not support the Hi-Color or true color video modes, use
  404.         the grayscale preview, otherwise use the true color preview.
  405.  
  406.  
  407.  
  408.